home *** CD-ROM | disk | FTP | other *** search
/ BCI NET 2 / BCI NET 2.iso / archives / programming / c / c2man-2.0pl33.lha / c2man-2.0 / vms / readme.1st < prev   
Encoding:
Text File  |  1995-01-24  |  4.3 KB  |  81 lines
  1.  
  2. *******************************************************************************
  3. **************************  README FOR VMS SYSTEMS ****************************
  4. *******************************************************************************
  5.                                                                    May 12, 1994
  6.                                                                    Rick Flower 
  7.                                                     <flower@donald.sp.trw.com>
  8.                                                     <flower@sdvax2.sp.trw.com>
  9.  
  10.  
  11. This file documents the differences between C2MAN for Unix and C2MAN for VMS
  12. systems.  The are some requirements that must be met in order to run C2MAN for
  13. VMS that are listed below.  You **CAN** (or should be able to) run C2MAN on
  14. VAX/AXP systems if you just install the GNU-CPP (see #1 below) since the
  15. there is no GNU-CC that supports the AXP architecture yet.
  16.  
  17.     1) You must either install a full GCC distribution OR install just the
  18.        CPP that is part of the standard CPP program!  If you are unable to
  19.            install the entire GCC system, the CPP program can be compiled and
  20.            built very easily directly from the main GCC distribution on any
  21.        GNU Anonymous FTP site (such as prep.ai.mit.edu in /pub/gnu or
  22.        on gatekeeper.dec.com in /pub/GNU).  There is a command file that
  23.            is part of the distribution that will make CPP.EXE using the 
  24.            standard CC (Vax-C or DEC-C) that you have..
  25.  
  26.     2) You will need BISON and FLEX which are also standard GNU tools that
  27.            can be made to run under VMS.  If I recall correctly, FLEX will
  28.            once again compile right-out-of-the-box and can be retrieved from
  29.            any GNU site (see #1 above for examples).  BISON on the other hand
  30.            appears to have some problems being built as of a while back.. I 
  31.            highly suggest that you look on one of the VMS fileserv's or any
  32.            other VMS FTP site to find a copy of BISON for VMS..  The install
  33.            procedure that is part of the standard GNU source distribution seems
  34.            to be a bit broken.. I got my version of BISON from one of the 
  35.            prebuilt GCC distributions available from DECUS (you might try on
  36.            nic.switch.ch in /mirror/vms/DECUS/vms93a/gccvms if you can't find
  37.            it elsewhere!).
  38.  
  39.     3) Once you've got the above requirements met, go into the [.vms]
  40.            directory and edit the MAKE.COM and make any necessary changes to
  41.            the CC,CFLAGS,LFLAGS, and the OPTFILE statement to indicate whether
  42.            you are using GCC or plain VAX-C.. (DEC-C should work without too 
  43.            much work!).  Once the changes are complete, make sure that you are
  44.            in the [.C2MAN] directory and then invoke @[.VMS]MAKE to build it.
  45.            You should end up with a C2MAN.EXE after a short period of time..  
  46.  
  47.     4) Before you invoke C2MAN, MAKE ABSOLUTELY SURE THAT YOU'VE GOT A 
  48.            SYMBOL SETUP CALLED "CPP" THAT WILL INVOKE THE GNU-CPP PROGRAM!!! If
  49.            you don't have a symbol setup, C2MAN will FAIL to run!  You can set
  50.            a symbol for CPP using the following as an example :
  51.  
  52.         $ CPP == $GNU_CC:[000000]GCC-CPP.EXE
  53.  
  54.        Just change the drive / directory specification to point to where 
  55.            you've got your CPP located.  You can test whether or not CPP is
  56.            working by invoking CPP at the "$" and press return.. You won't see
  57.            anything happen until you press CTRL-Z and you get something like :
  58.  
  59.         $ CPP
  60.         *EXIT*   (in reverse video!)
  61.                 # 1 ""
  62.                 $
  63.  
  64.        If you don't get that then you've not defined your CPP correctly..
  65.  
  66.     5) When you go and use C2MAN options that are uppercase letters, you
  67.            **MUST** quote them otherwise DCL will automatically change them
  68.            into lowercase letters which will probably cause C2MAN to complain
  69.            about unrecognized options being specified on the command line!!!
  70.            In other words, the following two commands are *NOT* identical in
  71.            function :
  72.  
  73.         $ C2MAN -V
  74.                 c2man: reading standard input
  75.  
  76.                 and
  77.                 $ C2MAN -"V"
  78.                 c2man: Version 2, Patchlevel 27
  79.                 c2man: reading standard input
  80.                 c2man: running `cpp -"C" -"D__C2MAN__=2" "-"'
  81.